home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm1 / cnetwho.lha / WHO_README! < prev   
Text File  |  1996-05-08  |  34KB  |  738 lines
  1. ============================================================================
  2.                CNet WHO's, v2.61 from Frontiers BBS! by Dotoran
  3. ============================================================================
  4.  
  5. What Is It?
  6. ~~~~~~~~~~~
  7.     This is the WHO replacement package you've been waiting for! Especially
  8. if you're a multi-line SysOp, as these are the FIRST EVER external WHO files
  9. that EXACTLY MIMIC CNet's WHO commands in ALL ways, including HIDDEN users!
  10.  
  11.     You will find three versions of the WHO command, each with it's own list
  12. of features:
  13.  
  14. "Short Who" - The "W" Command:
  15.  ~~~~~~~~~         ~
  16.     - Port Number (Scans ALL Loaded Ports. Will only display IDLE ports if
  17.                    you have this enabled through CNet's CONFIG program!)
  18.     - User's Handle
  19.     - Where the User IS in your System!
  20.     - Conference Control Flag (+) Supported 100%. (This means that users on
  21.       other ports who try to Hide or Muffle a Conf. Controller will appear
  22.       to do so on THEIR screens, but will FAIL to do so on the Controller's
  23.       WHO screen, just like CNET!)
  24.     - Hiding "h", and Muffling "m" fully supported.
  25.     - Attempted Hiding "H", and Attempted Muffling "M" also supported!
  26.       (This is what a Conference Controller will see on their WHO screens
  27.        of user's who are trying to Hide or Muffle them!)
  28.     - Idle Ports now have the ability to show how LONG they've been Idle,
  29.       provided you have "Show Idle Ports" set in CONFIG!
  30.     - Occupied Ports that have been IDLE for LONGER than 5 minutes now tell
  31.       you this, so that you can get an idea as to whether or not the user
  32.       on the port is REALLY there or not!
  33.     - Fully colorized, with two separate HELP menus for beginning users!
  34.  
  35.  
  36. "Normal Who" - The "WH" Command:
  37.  ~~~~~~~~~~         ~~
  38.     - Contains everything the "Short" format does, PLUS:
  39.     - Logon Time.
  40.     - Current CPS Rate (Baud/100).
  41.     - City, State, and Country User Hails From.
  42.     - User's Short, Internal CNet WHO Banner!
  43.     - Idle Ports can now use an optional IDLE Banner, a line of up to 54
  44.       characters that could possibly tell such info as phone numbers, baud
  45.       rates, times, etc. If an Idle Banner is NOT created, the user will be
  46.       shown the regular "<No One>  0  Idle" line instead, unless a DEFAULT
  47.       Idle Banner has also been created.
  48.  
  49.  
  50. "Long Who" - The "WHO" Command:
  51.  ~~~~~~~~         ~~~
  52.     - Contains all "Short" and "Normal" information, PLUS:
  53.     - Last Call Date.
  54.     - Gender of User (Male or Female)[Color Coded Blue or Red]
  55.     - Time Used Online TODAY (in Minutes)
  56.     - The User's 3-Line "Glimpse" file.
  57.     - A History Flag "*" Telling which Users Have History Files, which are
  58.       text files of up to 20-Lines!
  59.  
  60. ----------------------------------------------------------------------------
  61.     Of course, all appear in the FRONTIERS BBS Color Scheme, but can easily
  62. be changed by using the included CONFIG file.
  63.  
  64.     All three versions of the command may also take numeric arguments, which
  65. act just like CNet's built-in versions. These numbers represent the PORTS in
  66. which you wish to scan, like these examples illustrate:
  67.  
  68.     W 0-2             : Short WHO for Ports 0 thru 2.
  69.     WH 1 4 10         : Normal WHO for Ports 1, 4, and 10.
  70.     WHO 0-2,5.9 12-   : Long WHO for Ports 0 thru 2, 5, 9, and all Ports
  71.                         from 12 thru your Highest Loaded Port.
  72.  
  73.     Note that ALL forms of arguments are allowed:  2  0,3  1-4,  2.5.8, etc.
  74.  
  75.     Provided the user has the "Conference Control" flag set in their account,
  76. they may also specify the <C>onfig argument to load the CONFIG file:
  77.  
  78.     W C     : Load CONFIG, ready to Edit Short Who data.
  79.     WH C    : Load CONFIG, ready to Edit Normal Who data.
  80.     WHO C   : Load CONFIG, ready to Edit Long Who Data.
  81.               This version also allows for ALL Versions to be Created.
  82.  
  83.     You can type as much of the word CONFIG as you wish, but only the first
  84. letter will be looked at, so the following would also load the CONFIG:
  85.  
  86.     W CONFIG
  87.     WH CON
  88.     WHO C
  89.  
  90.     Also, when using the "Long" Who version, there are three more arguments
  91. that can be used to SKIP the WHO Listing and immediately enter one of the
  92. Long Who prompt commands. Again, you may type as MUCH of the keyword as you
  93. wish, but only the first letter is scanned:
  94.  
  95.     WHO B   (or WHO BANNERS, etc.) to edit/pick a Short Who Banner!
  96.     WHO G   (or WHO GLIMPSE, etc.) to edit their Glimpse File!
  97.     WHO H   (or WHO HISTORY, etc.) to edit their History File!
  98.     WHO V   (or WHO VIEW, etc.)    to edit their History File also!
  99.  
  100.     In addition, these NEW arguments have been added into v2.1c. Two are for
  101. Conference Controllers ONLY, and the other two are for ALL users:
  102.  
  103.     Conference Controllers ONLY:
  104.   ================================
  105.  
  106.     WHO I   (or WHO IDLES, etc.)   to ReLoad your Idle Who Banners!
  107.  
  108.     WHO E   (or WHO EDIT, etc.)    to Modify your Idle Who Banners!
  109.  
  110.         - The editor is entered, giving you 102 lines. This is to allow for
  111.           100 lines of regular ports, 1 line for a default banner, and 1
  112.           line for the Total Banners on file.
  113.  
  114.     Available to ALL Your Users:
  115.   ================================
  116.  
  117.     WHO P   (or WHO PORT, etc.)    to display CURRENT PORT's Idle Banner.
  118.  
  119.         - This comes in handy when a user wishes to know which phone number
  120.           they happened to call in on, etc.
  121.  
  122.     WHO Q   (or WHO QUICK, etc.)   to QUICK display the "Long" output.
  123.  
  124.         - "Quick" display will suppress the printing of Glimpses, lines of
  125.           separator characters BETWEEN each port, as well as any HELP MENUS
  126.           that may need to be printed, and finally the options prompt. What
  127.           is RETAINED is the Last Call Date, User Gender, History Flag and
  128.           Total Time Online Today, which is NOT shown in the "Normal" file.
  129.  
  130.     Lastly, all WHO's should be able to be aborted by pressing ANY key while
  131. they are displaying, without having to wait for the ENTIRE listing to be
  132. shown.
  133.  
  134.  
  135. How Do I Install It?
  136. ~~~~~~~~~~~~~~~~~~~~
  137. 1: Copy the "Who/" directory somewhere on your system, preferably somewhere
  138.    in your DOORS: assigned area. It doesn't matter WHERE you copy this Who/
  139.    directory, however make sure you leave ALL FILES TOGETHER inside of this
  140.    directory. Note the path you placed this directory for the following few
  141.    steps. (I'll assume you chose "doors:" in my explanations).
  142.  
  143. 2: Load your BBSMENU text file, found in the CNET: path, into any text editor
  144.    and make the following changes:
  145.  
  146.         A: Locate Menu # 2, Available Everywhere Menu, and find the entry
  147.            line containing the text "WHo" and place a "2" in FRONT of this
  148.            text, so that the text now reads "2WHo".
  149.  
  150.         B: At the BOTTOM of this Menu, add the following three lines:
  151.  
  152.                 WHO    `1- | {#0 doors:Who/Long}
  153.                 WHo    `1- | {#0 doors:Who/Normal}
  154.                 Who    `1- | {#0 doors:Who/Short}
  155.                              |
  156.                              `---> A Control-Q character.
  157.  
  158.           NOTE1: The CAPITALIZATION of the word "WHO" is VERY important in
  159.                  these three lines. The W, H, and O should ALL be UPPERCASE
  160.                  in the FIRST line, while only the W and H in the SECOND
  161.                  line, and ONLY the W in the THIRD line.
  162.  
  163.           NOTE2: Change the "doors:" path to the one you used in Step A
  164.                  above, if it differs from the default.
  165.  
  166.         C: Since CNet's built-in WHO command looks almost IDENTICAL to MY
  167.            "Normal WHo" version, I choose to use CNet's version instead of
  168.            mine. I do this, mainly for speeds sake. To make YOUR System use
  169.            CNet's WHO for the SECOND version, change the SECOND line above,
  170.            so that it reads like this:
  171.  
  172.                 WHo    `1- | {& 2WHo}
  173.                              |
  174.                              `---> A Control-Q character.
  175.  
  176.           NOTE1: The "2WHo" text, inside the {& } command, should appear the
  177.                  EXACT same as it appears in the BBSMENU file, as you changed
  178.                  it in step "A" above. That is, only the "W" and "H" should be
  179.                  capitalized.
  180.  
  181.           NOTE2: I use a "2" in front of the internal WHo command, instead
  182.                  of one of those oddball looking ALT-Graphic characters,
  183.                  because remote users can NOT produce these characters in
  184.                  their terminal programs, so would be UNABLE to invoke the
  185.                  "old" usage of this(or any other) "set aside" commands.
  186.  
  187.         D: Locate the "Write" command in the following Menus:
  188.  
  189.                 4; The new Message/File Area menu
  190.                 5; Respond or Pass?
  191.                 17; Mail
  192.                 20; Browse
  193.  
  194.            You must change the TEXT of this command, so that it reads:
  195.  
  196.                 WRite       instead of      Write
  197.                  |
  198.                  `---> Make this "R" UPPERCASE.
  199.  
  200.            This is a needed change, because unless you make this change, the
  201.            WRITE command will NOT function in these areas if the user types
  202.            "W" to change the description of a file, or enter the editor with
  203.            the current mail message(They'll be shown the SHORT WHO instead!)
  204.  
  205.         E: You will also want to update the following HELP files, which can
  206.            be found inside your "SysText:Help/" directory to reflect the
  207.            change you made in step "D" above:
  208.  
  209.                 mail   - Goes with Menu # 4 & 5
  210.                 post   - Goes with Menu # 17 & 20
  211.  
  212.            I checked the "browse" help file, but noticed the WRITE command
  213.            was not included in that file, so no changes are needed to that
  214.            file. To make the change, the line in question starts with:
  215.  
  216.                 \c7W\c6rite ...etc.
  217.  
  218.            Change it, so it looks like this:
  219.  
  220.                 \c7WR\c6ite ...etc.
  221.                 |    |
  222.                 `----`---> Remember, these are Control-Y characters!
  223.  
  224.         F: Load your BBSTEXT file into a text editor, then go to line 62 of
  225.            that file. It looks like this(in a stock 4.11 bbstext):
  226.  
  227.                         \n1@ Cleared for logon\n1
  228.                         |                     |
  229.                         `---- Control-Y's ----'
  230.  
  231.            To the end of this line, add the following:
  232.  
  233.                         {#0 doors:who/loader}
  234.                         ^
  235.                     Control-Q
  236.  
  237.            This will insure that the IdlePort Banners are loaded, as well
  238.            as updating the user's multiple who banners(if allowed).
  239.  
  240.         G: Edit the "IdlePorts" text file, included inside of the "Who/"
  241.            directory to contain the Idle Banners you wish to use. The format
  242.            of the file is fairly loose:
  243.  
  244.                 Line 1: Should contain a number, followed by at LEAST one
  245.                         SPACE, then any other text you wish. This NUMBER is
  246.                         the total number of lines BELOW that will be read
  247.                         into the computer the FIRST time someone logs onto
  248.                         the bbs AFTER this mod has been installed.
  249.  
  250.               Line 2-?: a|b
  251.                         ||`--> Idle Banner Text.
  252.                         |`---> Pipe (Vertical Bar) [To Right of Equals Sign]
  253.                         `----> The Port Number.
  254.  
  255.                     eg: 1|Line # 1, SupraFAX 28.8 (716)/823-9892
  256.  
  257.                  NOTE1: The port numbers do NOT have to come in ORDER in the
  258.                         file. Use whichever order best suits your need!
  259.  
  260.                  NOTE2: Starting the line with a "D" (minus the quotes),
  261.                         instead of a Port Number will define the DEFAULT
  262.                         Idle Banner to use for any ports that may be loaded,
  263.                         but that do NOT contain a premade Idle Banner.
  264.  
  265.         G: That's it! You're Done! You can RELOAD your BBSMENU and BBSTEXT
  266.            files by using the RAMIGA-T key combination!
  267.  
  268. What's This LONG WHO Command Menu?
  269. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  270.     Well, let's look at the command menu that appears BELOW the Long WHO's
  271. listing:
  272.  
  273.             Long Who [B]anner, [G]limpse, [V]iew History, or [QUIT]:
  274.  
  275.     From the above command menu, four commands are possible:
  276.  
  277. "[B]anner"
  278.  
  279.     - Allows the user to, then and there, edit the contents of their current
  280.       short CNet WHO Banner. (The same one available for editing via EP;14).
  281.       Their existing WHO Banner is displayed for the user as the default, so
  282.       they can make either small changes, or simply delete the whole thing
  283.       and start it over again.
  284.  
  285.     - The user is also allowed to enter MCI-Color Codes into their short
  286.       WHO Banner, using Control-Y type MCI codes.
  287.  
  288.             - NOTE: See the info below dealing with TOGGLE settings for more
  289.                     info on how you wish MCI's supported in the Who Banners.
  290.  
  291.     - They can also use the following SPECIAL Key-Strokes for editing:
  292.  
  293.             - CONTROL-X : Deletes EVERYTHING in the string gadget.
  294.             - CONTROL-B : Move Cursor to the Beginning of the string.
  295.             - CONTROL-N : Move Cursor to the eNd of the string.
  296.             - BACKSPACE : Delete character to LEFT of cursor, then move the
  297.                           cursor INTO that position.
  298.             - DELETE    : Will PULL text to the RIGHT of the cursor INTO the
  299.                           cursor, deleting characters as it goes.
  300.  
  301.     - For v2.0, this section received a bit more power, because NOW when the
  302.       user presses "B", they are taken to a NEW screen that allows them to
  303.       create MULTIPLE Short WHO Banners, up to TEN in all. They may choose
  304.       to EDIT any of them, using the techniques above, and can even swap the
  305.       "Current" Banner their using, in which case the NEW Banner would also
  306.       be permanently written to their user account(thus editable via EP;14).
  307.  
  308.     - You may disable this feature through the CONFIG file.
  309.  
  310.     - The user's Short Who Banners are stored in a file called "_Banners",
  311.       which is stored in the user's uucp mail directory inside the cnet
  312.       "mail:users/" directory.
  313.  
  314.     - For v2.1, the Loader was modified to perform a "Pick Banner" operation
  315.       whenever the user signs onto your board, PROVIDED a "Banners" file is
  316.       found for that user. This way, if they are using multiple different
  317.       banners, each call will activate a NEW banner for them, without the
  318.       user having to do it manually via "WHO B;P".
  319.  
  320. "[G]limpse"
  321.  
  322.     - The "Glimpse" files are three 78-character lines, EXCLUDING the Short
  323.       WHO Banner, that the user may create listing more info they want other
  324.       users to know about. These "Glimpse"'s are shown on the LONG version
  325.       who screen only.
  326.  
  327.     - The user is given the FULL POWER of the CNet Amiga Text Editor to enter
  328.       whatever they wish for their 3-Line "Glimpse" file. Use of ANY MCI's
  329.       the user has access to is fully supported.
  330.  
  331.     - If a user wishes to DELETE a "Glimpse" file, they should first enter
  332.       the editor with it, then DELETE it from the editor, using the .N
  333.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  334.       asking if they wish to DELETE the "Glimpse" file.
  335.  
  336.     - The Glimpse file is stored as "_Glimpse" in the user's uucp directory,
  337.       in the same way the banners are.
  338.  
  339.     - If a user does not have a "_Glimpse" file created in their uucp mail
  340.       directory, then the default glimpse file will be displayed when the
  341.       LONG who version is used, however this default file is NOT stored in
  342.       the user's uucp directory, but exists as "doors:who/_Glimpse".
  343.  
  344. "[H]istory"
  345.  
  346.     - You'll be given another command prompt when this command is used:
  347.  
  348.             [E]dit, [V]iew by Port, or [S]pecific Histories? [QUIT]:
  349.  
  350.     - If you choose to "[E]dit" your History file, any existing History will
  351.       be loaded into the CNet Editor, and you'll be given 20-Lines to enter
  352.       anything you'd like. The same editor features as the "Glimpses" are
  353.       allowed for use with "History" files.
  354.  
  355.     - If a user wishes to DELETE a "History" file, they should first enter
  356.       the editor with it, then DELETE it from the editor, using the .N
  357.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  358.       asking if they wish to DELETE the "History" file.
  359.  
  360.     - Pressing "[V]iew by Port" allows the user to view the History of a
  361.       user signed onto another port. Checks are made to insure their IS a
  362.       user on that port, and that the port is LOADED.
  363.  
  364.     - If you choose "[S]pecific Histories", you'll be asked to enter either
  365.       the ID Number, Handle, or Real Name of the user to view the History of.
  366.       If an incomplete Real Name or Handle is entered, you'll be shown the
  367.       User List menu, and can then choose the proper name off the menu. It is
  368.       possible to view your OWN History file by supplying your OWN info here.
  369.  
  370.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will take you back to the
  371.       initial command prompt.
  372.  
  373.     - The History file is stored as "_History" in the user's uucp directory,
  374.       in the same way the banners are.
  375.  
  376.     - If a user does not have a "_History" file created in their uucp mail
  377.       directory, then the default history file will be displayed when the
  378.       LONG who version is used, however this default file is NOT stored in
  379.       the user's uucp directory, but exists as "doors:who/_History".
  380.  
  381. "[QUIT]"
  382.  
  383.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will exit the Long Who,
  384.       and return you to the CNet Command Prompt that called WHO.
  385.  
  386. How do I use the CONFIG File?
  387. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  388.     One of the NEW features of v2.0 is the addition of an ANSI-ARexx style
  389. CONFIG program, written to mimic the VDE-type editors you may have seen and
  390. used with CNet before.
  391.  
  392.     You should enter the CONFIG program thru one of the WHO programs. Which
  393. WHO program you use to launch the CONFIG will have a bearing on which data
  394. items you will be able to edit on the various screens within the editor. For
  395. instance, things like Who Banners, Idle Port Banners, Glimpse Files, etc are
  396. not used in the SHORT form WHO program, so will appear as ghosted(black) on
  397. the CONFIG screen, and will not editable.
  398.  
  399.     As mentioned above, use one of the following three commands to load the
  400. CONFIG:
  401.             W C     : Enter CONFIG to edit Short Who data.
  402.             WH C    : Enter CONFIG to edit Normal Who data.
  403.             WHO C   : Enter CONFIG to edit Long Who data.
  404.  
  405.     You can also add the CONFIG file into your PFILES area as an Exclusive
  406. Use Only ARexx Pfile. You must specify an argument of W, WH, or WHO, so that
  407. the CONFIG will know WHICH WHO you wish to edit. Specify WHO if you wish to
  408. edit ALL of them at the same time. If the argument is NOT specified, the
  409. CONFIG file will exit, shortly after loading.
  410.  
  411.     Alright, you know HOW to load the CONFIG, now here's some info pertaining
  412. to certain things within the CONFIG that may need additional clarification:
  413.  
  414. Text String Gadgets:
  415. ~~~~~~~~~~~~~~~~~~~~
  416.     All text string gadgets may use the following SPECIAL key-strokes to aid
  417. in the entering/editing of text:
  418.  
  419.     CONTROL-X : Erase Everything.
  420.     CONTROL-B : Move to Beginning of Text.
  421.     CONTROL-N : Move to End of Text.
  422.     BACKSPACE : Delete Character to LEFT of Cursor.
  423.        DELETE : Pull Character to RIGHT of Cursor INTO the Cursor.
  424.  
  425.     In addition, each string gadget is formatted for the MAXIMIMUM allowed
  426. length that can be used in the Layout.
  427.  
  428. "BG"
  429.  ~~
  430.     Means a BackGround Color, and can be any of the following characters,
  431. which correspond to the equivalent MCI-Z Color Codes:
  432.  
  433.             0, 1, 2, 3, 4, 5, 6, and 7.
  434.  
  435. "FG"
  436.  ~~
  437.     Means a ForeGround Color, and can be any of the following characters,
  438. which correspond to the equivalent MCI-C Color Codes:
  439.  
  440.             0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, and f.
  441.  
  442. Use of BG and FG:
  443. ~~~~~~~~~~~~~~~~~
  444.     These fields use 1 character string gadgets. After pressing ENTER, you
  445. can do one of two things:
  446.  
  447.     1: Type a NEW value, which will then REPLACE the old value. Press ENTER
  448.        to confirm your choice, or use the BACKSPACE key to delete and try
  449.        again.
  450.  
  451.     2: Press ENTER again, in which case the NEXT value in sequence will be
  452.        used, so if the value WAS "a", it would become a "b". If the value
  453.        was "f", it would turn over and become a "0". A "3" would become a
  454.        "4", etc.
  455.  
  456. Use CNet "Stock" BBS
  457. Use "Frontiers"  BBS
  458. ~~~~~~~~~~~~~~~~~~~~
  459.     These two items allow you to select two built-in default settings. The
  460. "Stock" version is a rather plain looking color combination, while "Frontiers"
  461. is the familiar blue scenario that previous versions have used.
  462.  
  463. Saving Changes Made?
  464. ~~~~~~~~~~~~~~~~~~~~
  465.     The CONFIG uses a "Smart Save" feature, just like CNet's VDE Editors, so
  466. if all you do is load the CONFIG and LOOK at some values, when you select
  467. the "<< Exit" option, you will immediately exit the file, but if changes
  468. have been made, you'll get another screen asking if you'd like to SAVE the
  469. changes you've made.
  470.  
  471. ReLoad "IdlePorts"
  472. ~~~~~~~~~~~~~~~~~~
  473.     If you've made changes to the "IdlePorts" text file, you'll need to
  474. ReLoad them into memory, so that the NORMAL and LONG Who versions will
  475. reflect these changes.
  476.  
  477.     After selecting this option, a second or two will go by, then the screen
  478. should flash and you may hear a beep sound, which alerts you the process has
  479. completed.
  480.  
  481.     NOTE: Remember, as of v2.1c, you can now use "WHO I" to ReLoad the Idle
  482.           Port Banners as well.
  483.  
  484. CREATE SHORT WHO
  485. CREATE NORMAL WHO
  486. CREATE LONG WHO
  487. CREATE ALL WHO FILES
  488. ~~~~~~~~~~~~~~~~~~~~
  489.     Simply SAVING your changes is NOT all you have to do in order to BIND
  490. the changes you've done. When you're satisfied with the color/text choices
  491. you've made(use Show Example LayOuts), then you are ready to CREATE the WHO
  492. file.
  493.  
  494.     You have the option of creating a unique look for EACH of your WHO's, or
  495. you can use the "ALL WHO FILES" (only available in the LONG Who CONFIG) to
  496. use the Long Who settings to create ALL THREE versions.
  497.  
  498.     The CONFIG file actually GENERATES CUSTOM AREXX CODE containing the data
  499. you entered in the CONFIG program. This way, the WHO files execute a LOT
  500. faster than they would if they had to constantly read in a config file, set
  501. up a bunch of variables, then slap the variables into place.
  502.  
  503.     It also allows you to easily be able to EDIT any of the WHO files, if
  504. you find there are some small changes you'd like to make in ADDITION to
  505. those made by the CONFIG, however you need to follow this warning:
  506.  
  507. ***WARNING***
  508. =============
  509.  
  510.     Treat the "Short", "Normal", and "Long" text files the same way you would
  511. treat the BBSTEXT file, in that you should NOT alter the ORDER of the lines
  512. within each of these files.
  513.  
  514.     The "MakeWho" program is written to read in all the lines from each of
  515. these files, then REPLACE certain lines with those containing your CUSTOM
  516. values. ALTERING THE ORDER OR SEQUENCE of any of these files will result in
  517. CATASTROPHIC EVENTS! The "MakeWho" program may NOT be loaded externally by
  518. you through the Pfiles section. The CONFIG program MUST be the one that is
  519. used to call this file. (In other words, LEAVE THIS FILE ALONE!)
  520.  
  521.     Also, UNLIKE the BBSTEXT file, you should NOT alter the CONTENTS of any
  522. of the lines IF you think you'll be using the MAKEWHO program again, as any
  523. changes you make to the actual code MAY not be recreated by the MAKEWHO file,
  524. if the changed line contains an MCI-Color Code. If you note a problem in one
  525. of the lines, please alert me of the fact, so that I can take the proper
  526. steps to edit the MAKEWHO file to also correct the problem when you generate
  527. a NEW who format.
  528.  
  529.     After selecting this option, a few seconds will go by, then the screen
  530. should flash and you may hear a beep sound, which alerts you the process has
  531. completed.
  532.  
  533. Info On Toggle Switches:
  534. ~~~~~~~~~~~~~~~~~~~~~~~~
  535.     Show Idle Minutes
  536.     ~~~~~~~~~~~~~~~~~
  537.         Yes : Displays "Idle ?? Minutes" in WHERE Column.
  538.         No  : Displays "Idle"            in WHERE Column.
  539.  
  540.         NOTE: In v2.1, if set to "Yes", and more than 60 minutes have gone
  541.               by, then the value is recalculated in HOURS and displayed as
  542.               such. Also, if less than 60 minutes, you will also be shown
  543.               the TENTHS of minutes that have gone by, like "13.6 Minutes".
  544.  
  545.     Show Idle Banners
  546.     ~~~~~~~~~~~~~~~~~
  547.         Yes : Displays "IdlePortB?" line, if it exists.
  548.         No  : Displays "<no one>        0"  CNet's Default.
  549.  
  550.     Multiple Banners
  551.     ~~~~~~~~~~~~~~~~
  552.         Yes : Allow User to Use/Edit Multiple Short Who Banners.
  553.         No  : Disable this feature. User will have to resort to EP;14.
  554.  
  555.     Skip Idle Ports
  556.     ~~~~~~~~~~~~~~~
  557.         Yes : Will NOT print Port Info if it's an Idle(Empty) Port.
  558.         No  : Display Idle Port Info.
  559.  
  560.     Skip Hidden Ports
  561.     ~~~~~~~~~~~~~~~~~
  562.         yes : Will NOT print Port Info if User On that Port is HIDING.
  563.         No  : Will display this port as "appearing to be Idle".
  564.  
  565.         NOTE: When set to "No", CNet WHO uses an interesting trick to show
  566.               the number of minutes the port has been idle. The value used
  567.               here is actually the total number of minutes the CURRENT user
  568.               has been online(added to the FAKE Idle Time discussed below).
  569.  
  570.     Allow Banner MCI's
  571.     ~~~~~~~~~~~~~~~~~~
  572.         Yes : Allow the user to use MCI commands while creating Who Banners.
  573.         No  : Do NOT allow MCI's to be input into the Who Banners.
  574.  
  575.         NOTE: If this option is set to YES, but the user does not have the
  576.               ACCESS to use MCI's, then any MCI's entered by the user will
  577.               be automatically STRIPPED from the string. Also, if the user
  578.               has MCI-1 Access, but NOT MCI-2 Access, the MCI-2 Level MCI
  579.               codes will be STRIPPED if found.
  580.  
  581.     Allow SysOp  MCI's
  582.     ~~~~~~~~~~~~~~~~~~
  583.         Yes : Allow System Operators to use SYSOP-ONLY MCI's in Banners.
  584.         No  : SYSOP-ONLY MCI commands will be STRIPPED from Who Banners.
  585.  
  586.         NOTE: A "System Operator" is a user who has this priviledge flag
  587.               set in their user accounts. Lines 4 and 5 in your BBSTEXT file
  588.               determine which commands to deem SYSOP-ONLY(Line 4) and as
  589.               Level 2 MCI's(Line 5). Any commands NOT FOUND on these two
  590.               lines are available to users with Level 1 MCI Access. These
  591.               two lines are automatically read into the CONFIG program each
  592.               time it is used, so as to insure the proper stripping is done.
  593.  
  594.     Clear Screen Before
  595.     ~~~~~~~~~~~~~~~~~~~
  596.         Yes : The Screen is CLEARED BEFORE the WHO info is shown.
  597.         No  : The Screen is NOT cleared before the info is shown.
  598.  
  599.     Empty Port Block
  600.     ~~~~~~~~~~~~~~~~
  601.         Yes : Use following values to SPEED up the printing.
  602.         No  : Follow normal "1x1" iteration method.
  603.  
  604.     Port to Skip FROM
  605.     ~~~~~~~~~~~~~~~~~
  606.         When this port value is reached in the loop, the loop will then
  607.         IMMEDIATELY jump to the following value.
  608.  
  609.     Port to Skip TO
  610.     ~~~~~~~~~~~~~~~
  611.         The value to RESUME scanning for Port data. For instance, with these
  612.         ports set up:  0, 1, 2, 3, 98, and 99, you'd want to specify a "3"
  613.         in the FROM field, and "98" in the TO field, so that the who isn't
  614.         having to scan: 4, 5, 6, 7, 8, 9, 10, etc. etc. etc. up to 98!
  615.  
  616.     Fake Idle Minutes
  617.     ~~~~~~~~~~~~~~~~~
  618.         This value was included as a means of making HIDDEN USERS appear to
  619.         be hidden MORE SO over previous versions. Because these WHO programs
  620.         have the ability to specify how LONG a port has been IDLE, I needed
  621.         a way to fake idle time on HIDDEN ports. Earlier versions had me
  622.         just snagging the number of minutes the CURRENT user was ONLINE and
  623.         using that value, however I discovered that if a user initially logs
  624.         on, then immediately uses a WHO module, they'd see these HIDDEN
  625.         ports as being Idle for 0-1 Minutes, which made it look like these
  626.         ports logged OFF as soon as this user logged ON, so that's where
  627.         this value comes in. This value is ADDED TO the current user's time
  628.         online, and it's this SUM that is used for the IDLE TIME for HIDDEN
  629.         PORTS.
  630.  
  631. Manual Toggle Setting:
  632. ~~~~~~~~~~~~~~~~~~~~~~
  633.     It is also possible to MANUALLY set these toggles in each program by
  634. editing the given line in each version:
  635.  
  636.                           Line
  637.                          ======
  638.                     short: 14
  639.                    Normal: 15
  640.                      Long: 24
  641.  
  642.     Use values of "1" to represent YES, and "0" to represent NO in these
  643. variables, located on the above lines. If a version doesn't contain the
  644. given variable, then that version doesn't use/support that feature.
  645.  
  646.                         Variable    Toggle It Effects
  647.                         ========    ====================
  648.                            v1       show Idle Minutes
  649.                            v2       show Idle Banners
  650.                            v3       Multiple Banners
  651.                            v4       Skip Idle Ports
  652.                            v5       Skip Hidden Ports
  653.                            v6       Empty Port Block
  654.                            loS      Port to Skip FROM
  655.                            hiS      Port to Skip TO (Use hiSk in LONG)
  656.                            v7       Clear Screen Before
  657.                            v8       Allow MCI's in Who Banners?
  658.                            v9       Allow SysOp's to use SysOp-MCI's?
  659.  
  660.     Remember, ALL VARIABLES MUST RESIDE ON THE SAME LINE, as noted in the
  661. table above. Do NOT place them on individual lines, unless you plan on NOT
  662. using the CONFIG program to CREATE new layouts.
  663.  
  664. Is That It?
  665. ~~~~~~~~~~~
  666.     So far as I can tell, YES! I believe I've covered all the bases. I still
  667. have not been able to locate that ETA line used with File Transfers. I've
  668. been able to deduce that the ETA value is calculated "on the fly" as it's
  669. needed, which makes recreating this value a tough chore, as there are many
  670. getusers involved in calculating this value, MOST of which are accessable
  671. with known getusers, however the one key value I can't seem to locate is
  672. how MANY KILOBYTES have ALREADY been DOWNLOADED(or UPLOADED). Without this
  673. value, coming up with a "ball-park" ETA value is not obtainable.
  674.  
  675.     If you notice ANY, and I mean ANY problems with this version, PLEASE get
  676. in touch with me, either on Frontiers, Future World, thru Fido-Net Mail
  677. to "David Weeks@1:260/121", CLink-Net Mail to "David Weeks@911:6840/2.0",
  678. or on the InterNet via "dotoran@buffnet.net".
  679.  
  680.     There WILL be at least ONE more major release, but I can't put a date as
  681. to when you'll be seeing it, as I've got to start on it again from scratch!
  682.  
  683.     Enjoy this work! I put some serious work into it!
  684.                                                                   - Dotoran
  685.  
  686. In The Future?
  687. ~~~~~~~~~~~~~~
  688.     CNet WHO, v3.0 will be a complete rewrite, from the ground up, so that I
  689. can also include a custom DATA LAYOUT screen. What this means is you'll then
  690. be able to "pick and choose" exactly WHICH info you wish to show in each of
  691. your three WHO formats. Here's an ASCII shot of the screen layout I'm working
  692. on right now. This is still pretty sketchy, but you'll get the idea:
  693.  
  694. ---snip starts here---
  695.  
  696.                                Line 1
  697. -A B -C------------------ -J-------------
  698.  
  699. <---10---><---20---><---30---><---40---><---50---><---60---><---70---><--78-->
  700.  
  701. Port Number              Minimum Width: 2   Maximum Width: 4   Centered: Yes
  702. Width: 2   Text Bar: >P#<
  703. ForeGround: 4  BackGround: 6  Reversed: No   Underlined: No   BoldFaced: No
  704.  
  705.   *[A]*Port Number      [M] Last Call Date           [Y] Country Text
  706.    [B] Hide/Muffle Flag [N] Time Used Today          [Z] History Flag
  707.    [C] User Handle      [O] Primary Underscore       [1] Calls By This User
  708.    [D] User Real Name   [P] Secondary Underscore     [2] Balance Owing
  709.    [E] Logon Time       [Q] Total PFile Game Points  [3] Short Who Banner
  710.    [F] Logoff Time      [R] Access Group Number      [4] Glimpse File
  711.    [G] CPS Rate         [S] Access Group Name        [5] User ID Number
  712.    [H] Baud Rate        [T] Total Public Messages    [6] User SID Number
  713.    [I] City Text        [U] Total Uploaded Files     [7] Total File Credits
  714.    [J] Where Location   [V] Total Uploaded Bytes     [8] Total Byte Credits
  715.    [K] Gender Text      [W] Total Downloaded Files   [9] State Text
  716.    [L] Line Width       [X] Total Downloaded Bytes   [0] First Name
  717.  
  718. ---snip ends here---
  719.  
  720.     As you can see, I'm playing around with allowing you to pick from up to
  721. 36 different pieces of information. You can create WHO Layouts of up to 4
  722. lines each, where each line can contain ANY info you wish, in ANY order you
  723. wish, etc. I'm also playing around with the idea of attaching Access Group
  724. restrictions onto each data item, so that the data will only be shown to the
  725. user if their Access Group is high enough. If it's not, they'll just be shown
  726. some dead space in place of the info, or maybe I'll mask out the info. Not
  727. sure yet. I'm also playing around with the idea of creating custom TERMINAL
  728. versions for each file, so you can have ASCII, ANSI, and IBM-ANSI versions
  729. of the WHO files too.
  730.  
  731.     It's still in the planning stages right now, so if you have anything to
  732. ADD to these initial ideas, PLEASE forward them directly to me for inclusion
  733. into the next version!
  734.                                                                    - Dotoran
  735. ============================================================================
  736.                         Frontiers BBS (716)/823-9892!
  737. ============================================================================
  738.